home *** CD-ROM | disk | FTP | other *** search
/ Download Now 8 / Download Now V8.iso / Program / InternetTools / ApacheWebServer1.3.6 / apache_1_3_6_win32.exe / _SETUP.1 / Configuration.tmpl < prev    next >
Encoding:
Text File  |  1998-12-01  |  15.4 KB  |  394 lines

  1. # Config file for the Apache httpd.
  2.  
  3. # Configuration.tmpl is the template for Configuration. Configuration should
  4. # be edited to select the modules to be included as well as various flags
  5. # for Makefile.
  6.  
  7. # The template should only be changed when a new system or module is added,
  8. # or an existing one modified. This will also most likely require some minor
  9. # changes to Configure to recognize those changes.
  10.  
  11. # There are 5 types of lines here:
  12.  
  13. # '#' comments, distinguished by having a '#' as the first non-blank character
  14. #
  15. # Makefile options, such as CC=gcc, etc...
  16. #
  17. # Rules, distinguished by having "Rule" at the front. These are used to
  18. # control Configure's behavior as far as how to create Makefile.
  19. #
  20. # Module selection lines, distinguished by having 'AddModule' at the front.
  21. # These list the configured modules, in priority order (highest priority
  22. # last).  They're down at the bottom.
  23. #
  24. # Optional module selection lines, distinguished by having `%Module'
  25. # at the front.  These specify a module that is to be compiled in (but
  26. # not enabled).  The AddModule directive can be used to enable such a
  27. # module.  By default no such modules are defined.
  28.  
  29.  
  30. ################################################################
  31. # Makefile configuration
  32. #
  33. # These are added to the general flags determined by Configure.
  34. # Edit these to work around Configure if needed. The EXTRA_* family
  35. # will be added to the regular Makefile flags. For example, if you
  36. # want to compile with -Wall, then add that to EXTRA_CFLAGS. These
  37. # will be added to whatever flags Configure determines as appropriate
  38. # and needed for your platform.
  39. #
  40. # You can also set the compiler (CC) and optimization (OPTIM) used here as
  41. # well.  Settings here have priority; If not set, Configure will attempt to
  42. # guess the C compiler, looking for gcc first, then cc.
  43. #
  44. # Optimization note: 
  45. # Be careful when adding optimization flags (like -O3 or -O6) on the OPTIM
  46. # entry, especially when using some GCC variants. Experience showed that using
  47. # these for compiling Apache is risky. If you don't want to see Apache dumping
  48. # core regularly then at most use -O or -O2.
  49. #
  50. # The EXTRA_DEPS can be used to add extra Makefile dependencies to external
  51. # files (for instance third-party libraries) for the httpd target. The effect
  52. # is that httpd is relinked when those files are changed.
  53. #
  54. EXTRA_CFLAGS=
  55. EXTRA_LDFLAGS=
  56. EXTRA_LIBS=
  57. EXTRA_INCLUDES=
  58. EXTRA_DEPS=
  59.  
  60. #CC=
  61. #CPP=
  62. #OPTIM=
  63. #RANLIB=
  64.  
  65. ################################################################
  66. # Name of the installed Apache HTTP webserver.
  67. #
  68. #TARGET=
  69.  
  70. ################################################################
  71. # Dynamic Shared Object (DSO) support
  72. #
  73. # There is experimental support for compiling the Apache core and
  74. # the Apache modules into dynamic shared object (DSO) files for
  75. # maximum runtime flexibility.
  76. #
  77. # The Configure script currently has only limited built-in
  78. # knowledge on how to compile these DSO files because this is
  79. # heavily platform-dependent. The current state of supported and
  80. # explicitly unsupported platforms can be found in the file 
  81. # "htdocs/manual/dso.html", under "Supported Platforms".
  82. #
  83. # For other platforms where you want to use the DSO mechanism you
  84. # first have to make sure it supports the pragmatic dlopen()
  85. # system call and then you have to provide the appropriate
  86. # compiler and linker flags below to create the DSO files on your
  87. # particular platform.
  88. #
  89. # The placement of the Apache core into a DSO file is triggered
  90. # by the SHARED_CORE rule below while support for building
  91. # individual Apache Modules as DSO files and loading them under
  92. # runtime without recompilation is triggered by `SharedModule'
  93. # commands. To be able to use the latter one first enable the
  94. # module mod_so (see corresponding `AddModule' command below).
  95. # Then enable the DSO feature for particular modules individually
  96. # by replacing their `AddModule' command with `SharedModule' and
  97. # change the filename extension from `.o' to `.so'. 
  98. #
  99. # Sometimes the DSO files need to be linked against other shared
  100. # libraries to explicitly resolve symbols from them when the
  101. # httpd program not already contains references to them. For
  102. # instance when buidling mod_auth_db as a DSO you need to link
  103. # the DSO against the libdb explicity because the Apache kernel
  104. # has no references for this library. But the problem is that
  105. # this "chaining" is not supported on all platforms. Although one
  106. # usually can link a DSO against another DSO without linker
  107. # complains the linkage is not really done on these platforms.
  108. # So, when you receive "unresolved symbol" errors under runtime
  109. # when using the LoadModule directive for a particular module try
  110. # to enable the SHARED_CHAIN rule below.
  111.  
  112. #CFLAGS_SHLIB=
  113. #LD_SHLIB=
  114. #LDFLAGS_SHLIB=
  115. #LDFLAGS_SHLIB_EXPORT=
  116.  
  117. Rule SHARED_CORE=default
  118. Rule SHARED_CHAIN=default
  119.  
  120. ################################################################
  121. # Rules configuration
  122. #
  123. # These are used to let Configure know that we want certain
  124. # functions. The format is: Rule RULE=value
  125. #
  126. # At present, only the following RULES are known: WANTHSREGEX, SOCKS4,
  127. # SOCKS5, IRIXNIS, IRIXN32 and PARANOID.
  128. #
  129. # For all Rules, if set to "yes", then Configure knows we want that
  130. # capability and does what is required to add it in. If set to "default"
  131. # then Configure makes a "best guess"; if set to anything else, or not
  132. # present, then nothing is done.
  133. #
  134. # SOCKS4:
  135. #  If SOCKS4 is set to 'yes', be sure that you add the socks library
  136. #  location to EXTRA_LIBS, otherwise Configure will assume
  137. #  "-L/usr/local/lib -lsocks"
  138. #
  139. # SOCKS5:
  140. #  If SOCKS5 is set to 'yes', be sure that you add the socks5 library
  141. #  location to EXTRA_LIBS, otherwise Configure will assume
  142. #  "-L/usr/local/lib -lsocks5"
  143. #
  144. # IRIXNIS:
  145. #  Only takes effect if Configure determines that you are running
  146. #  SGI IRIX.  If you are using a (ancient) 4.x version of IRIX, you
  147. #  need this if you are using NIS and Apache needs access to it for
  148. #  things like mod_userdir.  This is not required on 5.x and later
  149. #  and you should not enable it on such systems.
  150. #
  151. # IRIXN32:
  152. #  If you are running a version of IRIX and Configure detects
  153. #  n32 libraries, it will use those instead of the o32 ones.
  154. #
  155. # PARANOID:
  156. #  New with version 1.3, during Configure modules can run
  157. #  pre-programmed shell commands in the same environment that
  158. #  Configure runs in. This allows modules to control how Configure
  159. #  works. Normally, Configure will simply note that a module
  160. #  is performing this function. If PARANOID is set to yes, it will
  161. #  actually print-out the code that the modules execute
  162. #
  163.  
  164. Rule SOCKS4=no
  165. Rule SOCKS5=no
  166. Rule IRIXNIS=no
  167. Rule IRIXN32=yes
  168. Rule PARANOID=no
  169.  
  170. # The following rules should be set automatically by Configure. However, if
  171. # they are not set by Configure (because we don't know the correct value for
  172. # your platform), or are set incorrectly, you may override them here.
  173. # If you have to do this, please let us know what you set and what your
  174. # platform is, by filling out a problem report form at the Apache web site:
  175. # <http://bugs.apache.org/>.  If your browser is forms-incapable, you
  176. # can get the information to us by sending mail to apache-bugs@apache.org.
  177. #
  178. # WANTHSREGEX:
  179. #  Apache requires a POSIX regex implementation. Henry Spencer's
  180. #  excellent regex package is included with Apache and can be used
  181. #  if desired. If your OS has a decent regex, you can elect to
  182. #  not use this one by setting WANTHSREGEX to 'no' or commenting
  183. #  out the Rule. The "default" action is "yes" unless overruled
  184. #  by OS specifics
  185.  
  186. Rule WANTHSREGEX=default
  187.  
  188. ################################################################
  189. # Module configuration
  190. #
  191. # Modules are listed in reverse priority order --- the ones that come
  192. # later can override the behavior of those that come earlier.  This
  193. # can have visible effects; for instance, if UserDir followed Alias,
  194. # you couldn't alias out a particular user's home directory.
  195.  
  196. # The configuration below is what we consider a decent default 
  197. # configuration.  If you want the functionality provided by a particular
  198. # module, remove the "#" sign at the beginning of the line. But remember, 
  199. # the more modules you compile into the server, the larger the executable
  200. # is and the more memory it will take, so if you are unlikely to use the
  201. # functionality of a particular module you might wish to leave it out.
  202.  
  203. ## mod_mmap_static is an experimental module, you almost certainly
  204. ## don't need it.  It can make some webservers faster.  No further
  205. ## documentation is provided here because you'd be foolish
  206. ## to use mod_mmap_static without reading the full documentation.
  207.  
  208. # AddModule modules/experimental/mod_mmap_static.o
  209.  
  210. ##
  211. ## Config manipulation modules
  212. ##
  213. ## mod_env sets up additional or restricted environment variables to be
  214. ## passed to CGI/SSI scripts.  It is listed first (lowest priority) since
  215. ## it does not do per-request stuff.
  216.  
  217. AddModule modules/standard/mod_env.o
  218.  
  219. ##
  220. ## Request logging modules
  221. ##
  222.  
  223. AddModule modules/standard/mod_log_config.o
  224.  
  225. ## Optional modules for NCSA user-agent/referer logging compatibility
  226. ## We recommend, however, that you just use the configurable access_log.
  227.  
  228. # AddModule modules/standard/mod_log_agent.o
  229. # AddModule modules/standard/mod_log_referer.o
  230.  
  231. ##
  232. ## Type checking modules
  233. ##
  234. ## mod_mime_magic determines the type of a file by examining a few bytes
  235. ## of it and testing against a database of filetype signatures.  It is
  236. ## based on the unix file(1) command.
  237. ## mod_mime maps filename extensions to content types, encodings, and
  238. ## "magic" type handlers (the latter is obsoleted by mod_actions, and
  239. ## don't confuse it with the previous module).
  240. ## mod_negotiation allows content selection based on the Accept* headers.
  241.  
  242. # AddModule modules/standard/mod_mime_magic.o
  243. AddModule modules/standard/mod_mime.o
  244. AddModule modules/standard/mod_negotiation.o
  245.  
  246. ##
  247. ## Content delivery modules
  248. ##
  249. ## The status module allows the server to display current details about 
  250. ## how well it is performing and what it is doing.  Consider also enabling 
  251. ## the 'ExtendedStatus On' directive to allow full status information.
  252. ## Please note that doing so can result in a palpable performance hit.
  253.  
  254. AddModule modules/standard/mod_status.o
  255.  
  256. ## The Info module displays configuration information for the server and 
  257. ## all included modules. It's very useful for debugging.
  258.  
  259. # AddModule modules/standard/mod_info.o
  260.  
  261. ## mod_include translates server-side include (SSI) statements in text files.
  262. ## mod_autoindex handles requests for directories which have no index file
  263. ## mod_dir handles requests on directories and directory index files.
  264. ## mod_cgi handles CGI scripts.
  265.  
  266. AddModule modules/standard/mod_include.o
  267. AddModule modules/standard/mod_autoindex.o
  268. AddModule modules/standard/mod_dir.o
  269. AddModule modules/standard/mod_cgi.o
  270.  
  271. ## The asis module implements ".asis" file types, which allow the embedding
  272. ## of HTTP headers at the beginning of the document.  mod_imap handles internal 
  273. ## imagemaps (no more cgi-bin/imagemap/!).  mod_actions is used to specify 
  274. ## CGI scripts which act as "handlers" for particular files, for example to
  275. ## automatically convert every GIF to another file type.
  276.  
  277. AddModule modules/standard/mod_asis.o
  278. AddModule modules/standard/mod_imap.o
  279. AddModule modules/standard/mod_actions.o
  280.  
  281. ##
  282. ## URL translation modules.
  283. ##
  284.  
  285. ## The Speling module attempts to correct misspellings of URLs that
  286. ## users might have entered, namely by checking capitalizations
  287. ## or by allowing up to one misspelling (character insertion / omission /
  288. ## transposition/typo). This catches the majority of misspelled requests.
  289. ## If it finds a match, a "spelling corrected" redirection is returned.
  290.  
  291. # AddModule modules/standard/mod_speling.o
  292.  
  293. ## The UserDir module for selecting resource directories by user name
  294. ## and a common prefix, e.g., /~<user> , /usr/web/<user> , etc.
  295.  
  296. AddModule modules/standard/mod_userdir.o
  297.  
  298. ## The proxy module enables the server to act as a proxy for outside
  299. ## http and ftp services. It's not as complete as it could be yet.
  300. ## NOTE: You do not want this module UNLESS you are running a proxy;
  301. ##       it is not needed for normal (origin server) operation.
  302.  
  303. # AddModule modules/proxy/libproxy.a
  304.  
  305. ## The Alias module provides simple URL translation and redirection.
  306.  
  307. AddModule modules/standard/mod_alias.o
  308.  
  309. ## The URL rewriting module allows for powerful URI-to-URI and 
  310. ## URI-to-filename mapping using a regular expression based 
  311. ## rule-controlled rewriting engine.
  312.  
  313. # AddModule modules/standard/mod_rewrite.o
  314.  
  315. ##
  316. ## Access control and authentication modules. 
  317. ##
  318. AddModule modules/standard/mod_access.o
  319. AddModule modules/standard/mod_auth.o
  320.  
  321. ## The anon_auth module allows for anonymous-FTP-style username/ 
  322. ## password authentication.
  323.  
  324. # AddModule modules/standard/mod_auth_anon.o
  325.  
  326. ## db_auth and dbm_auth work with Berkeley DB files - make sure there
  327. ## is support for DBM files on your system.  You may need to grab the GNU
  328. ## "gdbm" package if not and possibly adjust EXTRA_LIBS. (This may be
  329. ## done by Configure at a later date)
  330.  
  331. # AddModule modules/standard/mod_auth_dbm.o
  332. # AddModule modules/standard/mod_auth_db.o
  333.  
  334. ## "digest" implements HTTP Digest Authentication rather than the less 
  335. ## secure Basic Auth used by the other modules.
  336.  
  337. # AddModule modules/standard/mod_digest.o
  338.  
  339. ## Optional response header manipulation modules. 
  340. ##
  341. ## cern_meta mimics the behavior of the CERN web server with regards to 
  342. ## metainformation files.  
  343.  
  344. # AddModule modules/standard/mod_cern_meta.o
  345.  
  346. ## The expires module can apply Expires: headers to resources,
  347. ## as a function of access time or modification time.
  348.  
  349. # AddModule modules/standard/mod_expires.o
  350.  
  351. ## The headers module can set arbitrary HTTP response headers,
  352. ## as configured in server, vhost, access.conf or .htaccess configs
  353.  
  354. # AddModule modules/standard/mod_headers.o
  355.  
  356. ## Miscellaneous modules
  357. ##
  358. ## mod_usertrack is the new name for mod_cookies.  This module
  359. ## uses Netscape cookies to automatically construct and log
  360. ## click-trails from Netscape cookies, or compatible clients who
  361. ## aren't coming in via proxy.   
  362. ##
  363. ## You do not need this, or any other module to allow your site
  364. ## to use Cookies.  This module is for user tracking only
  365.  
  366. # AddModule modules/standard/mod_usertrack.o
  367.  
  368. ## The example module, which demonstrates the use of the API.  See
  369. ## the file modules/example/README for details.  This module should
  370. ## only be used for testing -- DO NOT ENABLE IT on a production server.
  371.  
  372. # AddModule modules/example/mod_example.o
  373.  
  374. ## mod_unique_id generates unique identifiers for each hit, which are
  375. ## available in the environment variable UNIQUE_ID.  It may not work on all
  376. ## systems, hence it is not included by default.
  377.  
  378. # AddModule modules/standard/mod_unique_id.o
  379.  
  380. ## mod_so lets you add modules to Apache without recompiling.
  381. ## This is an experimental feature at this stage and only supported 
  382. ## on a subset of the platforms we generally support. 
  383. ## Don't change this entry to a 'SharedModule' variant (Bootstrapping!)
  384.  
  385. # AddModule modules/standard/mod_so.o
  386.  
  387. ## mod_setenvif lets you set environment variables based on the HTTP header
  388. ## fields in the request; this is useful for conditional HTML, for example.
  389. ## Since it is also used to detect buggy browsers for workarounds, it
  390. ## should be the last (highest priority) module.
  391.  
  392. AddModule modules/standard/mod_setenvif.o
  393.  
  394.